home *** CD-ROM | disk | FTP | other *** search
/ Power Tools for Macintosh / Power Tools for Macintosh (SoftBit)(1992).iso / Da's / A-B / AddLPrep / AddLPrep docs < prev    next >
Text File  |  1988-03-12  |  8KB  |  154 lines
  1. AddLPrep Documentation  3/2/88
  2.  
  3. Originally, Apple's LaserWriter system allowed a user to get a 
  4.  complete PostScript disk file (including the library code from the 
  5.  "Laser Prep" file) by hitting a Command-K quickly after 
  6.  choosing OK from the LaserWriter Print dialog, or a file without
  7.  the library code by hitting Command-F.  The keys have since changed
  8.  to Option-K and Option-F, but both now seem to function equivalently
  9.  to the old Command-F.
  10.  
  11. The AddLPrep program adds the PostScript code from the Laser Prep 
  12.  file to a PostScript file created by hitting Option-F (or K).
  13. The output file produced by AddLPrep is thus suitable for
  14.  downloading to any PostScript printer or typesetter.
  15.  
  16. VERY IMPORTANT: AddLPrep is SHAREWARE and is copyright © 1988 by 
  17.  Software101, Los Gatos, CA.  Feel free to try it out and give 
  18.  copies to others, but if you find the program useful and continue 
  19.  to use it, send $20 to Software101, 101 Fremont Court, Los Gatos, CA
  20.  95030.  As indicated below, this program may need considerable 
  21.  support; problems will be solved only for those who have paid 
  22.  for the program.  Someday, in some manner, new versions may be 
  23.  available only to those honest folks.
  24.  
  25. "Thank you for your support"
  26.                     -- Bartles & Jaymes, 1986
  27.  
  28. ALSO VERY IMPORTANT: The contents of the Laser Prep file are copyrighted 
  29.  by Apple Computer, and using the output of this program for any 
  30.  purpose other than 1) downloading to a PostScript printer, or 
  31.  2) study of PostScript programming techniques, is almost 
  32.  certainly a violation of that copyright.
  33.  
  34. GETTING READY:
  35. Since you're reading this, you've already mastered the first step:
  36. unpacking the distribution (.sit) file using the Stuffit program.
  37. There are two versions of AddLPrep in this package; one is an application
  38. that can be started from the Finder, the other is a Desk Accessory that
  39. can be selected from the Apple menu while using any program that supports
  40. Desk Accessories (most do).
  41.  
  42. If you want to use the Desk Accessory version, the next step is to
  43. use Apple's Font/DA Mover program to move the contents of the AddLPrepDA
  44. file to your System file.  If you don't have a hard disk, you'll need 
  45. to transfer it to the System files on all the floppies you want to use 
  46. it with.
  47.  
  48. In order to use either version, you must have a copy of the LaserWriter
  49. driver and the matching Laser Prep file in your System Folder (if you
  50. dont have a hard disk, in the System Folders on all the floppies you want 
  51. to use it with.
  52.  
  53. OPERATION: 
  54.  1) If necessary, use the Chooser DA to select the LaserWriter.
  55.     You don't have to actually have a LaserWriter connected to 
  56.     your Mac, but if you have an ImageWriter or something else
  57.     connected to your serial Printer port, be sure to turn its
  58.     power off before you use Chooser!
  59.  2) Start the application that produces the printout you want,
  60.     and open the document you want to print.  Or, just double-
  61.     click on the document from the Finder.  Or, most elegantly,
  62.     single-click on the document and choose Print from the Finder's
  63.     File menu.
  64.  3) Unless you did so from the Finder, choose Print from the 
  65.     application's File menu.
  66.  4) After selecting whatever options you want from from the LaserWriter 
  67.     Print dialog, click on OK or hit Return, then quickly hit Option-F. 
  68.     REAL quickly: it may take several tries before you see a box that 
  69.     says something like "Creating PostScript file", rather than one 
  70.     that says "Looking for LaserWriter...".  With some programs 
  71.     it's possible to hold down Option-F (so as to repeat the key)
  72.     before clicking on OK.
  73.  5) If you see the right message, a disk file will be created named 
  74.     "PostScriptn", where n is typically 0.  It may end up in the 
  75.     System Folder, the folder the application is in, or (?) somewhere 
  76.     else.  You may have to use the Find File DA to find it.
  77. 6A) WITH THE APPLICATION VERSION OF AddLPrep:
  78.     * Quit the application.
  79.     * In the Finder, you may want to rename the file to something 
  80.       more meaningful.  
  81.     * Run the addLPrep application.
  82. 6B) WITH THE DESK ACCESSORY VERSION:
  83.     * Choose AddLPrep from the Apple menu.
  84.  7) With either version, a standard file selection box appears.  Choose 
  85.     the file created in steps 4-5, and double-click on it, or click on 
  86.     Open, or hit Return.
  87.  8) A new dialog box then appears, telling you that AddLPrep is converting
  88.     your file, and the cursor changes to a watch.  Depending on how long 
  89.     and complex your printout is, and what kind of Mac you have, the 
  90.     process may take a few seconds to several minutes.  You can cancel
  91.     the process by clicking on the button in the dialog box, or holding 
  92.     down the Command (Apple) key and pressing the '.' key.
  93.  9) When it's done, the application version will quit to the Finder,
  94.     while the DA version will just go away.  Unless you cancelled, there 
  95.     is then another new file, with the same filename plus ".ps" at the end.
  96.     This is a complete PostScript file (program) suitable for direct 
  97.     downloading to any PostScript printer or typesetter.
  98.  
  99. TECHNICAL NOTE:
  100. AddLPrep substitutes the Laser Prep code for a line starting with:
  101. %%IncludeProcSet: "(AppleDict md)"
  102. If the input file does not contain a line like this, then AddLPrep
  103. produces an Alert box noting that it has just functioned as a text file
  104. duplicating program.  (This will not occur for files created by Option-F
  105. as described above.)
  106.  
  107. ABOUT RELIABILITY:
  108. As AddLPrep transfers the PostScript code from the Laser Prep
  109. file to the output file, it makes a few modifications to the code
  110. to make it suitable for use as a "transient" program that doesn't 
  111. "take over" the printer or modify its state.  AddLPrep has been 
  112. tested with a number of common Mac applications and with a DEC 
  113. ScriptPrinter.  However, it may prove unreliable in any of the 
  114. following cases:
  115.  
  116. a) when used with a version of Laser Prep that's newer or older than 
  117.    the one distributed with Apple's System Software 5.0 (a.k.a. System 
  118.    4.2/Finder 6.0).  That Laser Prep file doesn't show a version in the 
  119.    Finder's Get Info box, but the associated LaserWriter file shows 5.0.
  120.    Internally, the code is called version 65 or maybe 66.  If the Laser
  121.    Prep file is sufficiently different, AddLPrep will detect the problem
  122.    and show an Alert box.  Or,
  123.  
  124. b) when used with a different PostScript printer, or
  125.  
  126. c) when used with applications other than those the author has tested
  127.    it with, or
  128.  
  129. d) when used with documents that contain graphic shapes other than 
  130.    those the author happens to have tested (e.g., arcs have not been
  131.    tested).
  132.  
  133. The most likely source of problems is a), for future versions of Laser 
  134. Prep.
  135.  
  136. Problems can be reported to the author via EMail to CompuServe
  137. 72367,2599 or GEnie MACKENNA, but please be patient.  Assuming a ".ps" 
  138. file was produced and it's less than, say, 32Kbytes long, upload it on 
  139. EMail along with the description of the problem.  
  140.  
  141. If you have a problem with a huge PostScript file, try to reproduce it 
  142. in a small file.  For multi-page printouts, a problem is automatically
  143. isolated to the first page that doesn't print out, and other pages can 
  144. be deleted from the PostScript file.  The start of each page is marked 
  145. by a line like
  146. %%Page: n
  147. Always keep the part of the file before the start of page 1.
  148.  
  149. To isolate problems further, try inserting lines like 
  150. (we got to here) print
  151. in the PostScript code.  The messages before the problem will come back
  152. from the PostScript printer, before the error message.  Warning: figuring
  153. out where to put those lines may turn you into a PostScript programmer!
  154.